Uploaded image for project: 'Tapestry 5'
  1. Tapestry 5
  2. TAP5-502

Improve the description of parameter passing and binding in the documentation

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • 5.0.18
    • 5.1.0.1
    • documentation
    • None

    Description

      It seem that the documentation for parameter is milseading.
      The way parameter are defined and passed between a parent component and its child use to be really well explained (I think it was in the "Parameter" page, but I'm not sure). It seems that the introduction text which use to deal with the concept is no more in the Parameter documentation, what leads to really big miscomprehension from user.

      It would be really great to add again something about that at the beginning of the parameter page (before the loop example).

      That is the text in the T5 refcard on that topic, which seems quite good:
      ===
      A page binds the parameters of its child components. For example, a TextField properties
      component's value parameter is bound to a property, or property expression, indicating what object property it will
      read (when rendering) or update (when the containing form is submitted).
      ===

      And there used to be something about parameter being a conduit, both read and write, between a component and it's container that was quite nice too.

      Attachments

        Activity

          People

            hlship Howard Lewis Ship
            fanf42 Francois Armand
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: